T-구글 api 사용 가이드

단계

  1. 구글 클라우드 프로젝트 생성
    1. 한번 만든 이력이 있다면, 새로 할 필요는 없다.
  2. 사용할 API 설정
    1. 다양한 API가 존재하며, 기본적으로는 비사용 상태이다.
      Pasted image 20240610000005.png
    2. 참고로 gcloud를 통해 cli로 세팅하는 것도 가능하다.
  3. 접근 및 조작을 위한 인증, 승인 과정

Google Workspace API 인증 및 승인

처음 구글의 개발 도구를 접할 때 어려운 것 중 하나가 바로 인증, 승인이다.
Pasted image 20240610001055.png
대략 다음의 과정을 거친다.

  1. 구글 클라우드 프로젝트 및 앱 구성
    1. 구글 콘솔에 앱을 등록하고 API 키, 사용자 인증 정보와 승인 범위를 정의한다.
  2. 액세스를 위한 앱 인증
    1. 앱 실행 시 등록된 사용자 인증 정보를 평가한다.
    2. 로그인 메시지가 표시될 수 있다.
  3. 리소스 요청
    1. 앱이 리소스에 접근할 경우 위 과정에서 등록한 범위를 토대로 구글에 요청한다.
  4. 사용자 동의 요청
    1. 앱이 최종 사용자로 인증할 경우, OAuth를 통해 앱에 접근 권한을 결정하도록 한다.
  5. 승인된 리소스 요청 전송
    1. 액세스 범위 동의가 완료되면 인증 정보와 승인된 액세스 범위를 번들로 묶고 액세스 토큰 요청이 전송된다.
  6. 액세스 토큰 반환
    1. 구글은 액세스 토큰을 반환한다.
  7. 요청된 리소스 액세스
    1. 액세스 토큰을 통해 관련 API를 호출한다.
  8. 이후에는 한 주기가 끝난 이후 추가 요청이 일어나는 과정이다.